The Resolution ('resl') Resource(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 6 - Printing Resources / Printing Resources Reference

Resources Used Only in Printer Drivers

The Resolution ('resl') Resource
The resolution ('resl') resource, of type gxReslType, is used to define the resolution values that a driver supports. This resource is optional: if you do not provide one, the resolution values in the customization resource are used. If you do not provide a resolution resource or a customization resource, the default customization values (the defaults for the updriver) are used. You can define a range of resolution values in a single resolution resource. Figure 6-17 shows the structure of resolution resource.
Figure 6-17 The resolution resource

The resolution resource defines the resolution range for a driver and contains a variable number of specific resolution entries.

Range type. A constant value of 1.
x minimum resolution. The minimum horizontal resolution supported by the driver in dots per inch (dpi).
x maximum resolution. The maximum horizontal resolution supported by the
driver in dpi.
y minimum resolution. The minimum vertical resolution supported by the
driver in dpi.
y maximum resolution. The maximum vertical resolution supported by the
driver in dpi.
Count. The number of resolution pairs that follow in this resource.

Two values are defined for each specific resolution entry.

x resolution. The horizontal resolution of this entry in dpi.
y resolution. The vertical resolution of this entry in dpi.

The resolution resource ID needs to be -8192. Listing 6-15 shows an example of a resolution resource.
Listing 6-15 An example of a resolution resource
resource gxReslType (-8192, sysHeap, purgeable)
{
   rangeType,
   25, 1500,
   25, 1500,
   {
   300, 300;
   600, 600;
   };
};
This resource is for a printing device that supports resolutions from 25 to 1500 dpi. The recommended resolutions values are 300 and 600 dpi.